home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / stack19.zip / ST!SYSOP.DOC < prev    next >
Text File  |  1992-09-05  |  12KB  |  287 lines
  1.     //////////////////////////////////////////////////////////////////
  2.     /                                                                /
  3.     /                            Stack'Em!                           /
  4.     /                           Version 1.9                          /
  5.     /                                                                /
  6.     /                        (c) Copyright 1992                      /
  7.     /                        All Rights Reserved                     /
  8.     /                          J & W Software                        /
  9.     /                                                                /
  10.     /                                                                /
  11.     /       DOOR game for Wildcat!, PCBoard 14.x, RA/QBBS, GAP,      /
  12.     /       SPITFIRE  and  other BBS  software which  uses door      /
  13.     /       information files compatible with the above.             /
  14.     /                                                                /
  15.     /                                                                /
  16.     /                           Support BBS:                         /
  17.     /                          Gulf Coast BBS                        /
  18.     /                          (904) 563-2547                        /
  19.     /                     1200 - 14400 HST/v.32bis                   /
  20.     //////////////////////////////////////////////////////////////////
  21.  
  22.  
  23.     INTRODUCTION
  24.     ------------
  25.  
  26.     Stack'Em! is  a game where the player has to join different shaped
  27.     falling  pieces  together  to  form  completed  horizontal  lines.
  28.     Scoring is based on how many pieces are played and number of lines
  29.     completed.  Players  compete for weekly high  score as well as All
  30.     Time High Scorer.
  31.  
  32.  
  33.     FEATURES
  34.     --------
  35.  
  36.     - ANSI Color and Mono screens with animation
  37.     - Full multi-node support
  38.     - Support for locked DTE up to 115K bps
  39.     - Support for non-standard COM3 and COM4 ports
  40.     - DESQview aware
  41.     - Easy installation and no maintenance
  42.  
  43.  
  44.     SETUP
  45.     -----
  46.  
  47.     Setup  is  very simple.  Create a directory and  place  the  files 
  48.     STACKEM.EXE and ST!SETUP.EXE in this directory.
  49.  
  50.     Change to this directory and run ST!SETUP.  A screen with  several
  51.     fields  will be displayed.  There will be a box at the  bottom  of 
  52.     the  screen that will  display  help  information for each  field.
  53.     The  following  edit keys  are allowed: HOME, END, BACKSPACE, LEFT
  54.     and RIGHT ARROW. Use the ENTER,  UP  and  DOWN  ARROW keys to move
  55.     between the different fields.
  56.  
  57.     Each field is described below:
  58.  
  59.     Name: The name of the person registering the program as it will be
  60.     displayed on  the opening screen (when registered).  This does not
  61.     necessarily have to be the SysOp, it could be the name of the user
  62.     who donated the registration fee.
  63.  
  64.     BBS Name:  The  name of the  BBS  as  it  will be displayed on the
  65.     opening screen (when registered).
  66.  
  67.     Key Number:  If registered, enter your Key Number here.  Until the
  68.     program  is registered leave this field  as  all zeroes.   See the
  69.     registration section below for more information about registering.
  70.  
  71.     Allowable plays per day:  The number of plays per day that will be
  72.     allowed.  A value of 0 means unlimited plays per day.
  73.  
  74.     Display 'Next Piece' [Y/N]:  If 'Y', the next piece  to  be played
  75.     will be displayed to the player.
  76.  
  77.     Use the  'Doughnut'  piece [Y/N]:  If 'Y',  the  large  'Doughnut'
  78.     shaped piece will be used.  You may not want to use the 'Doughnut'
  79.     shaped piece if small children will be playing the game.
  80.  
  81.                                    Doughnut
  82.  
  83.                                     ██████
  84.                                     ██  ██
  85.                                     ██████
  86.  
  87.  
  88.  
  89.     Penalty for  Throw Away Piece  command:  Set this to the amount of
  90.     points to subtract from the players  score when they use the Throw
  91.     Away Piece  command.  If you  choose to enable  this command it is
  92.     recommended that this be set  to a minimum of 500 points.  A value
  93.     of 0 will disable the command not allowing it to be used.
  94.  
  95.     Path and Name of ANSI Bulletin: Path and name for the ANSI (Color)
  96.     bulletin file. If left blank no file will be written.
  97.  
  98.     Path and Name of ASCII Bulletin: Path and name for the ASCII (Non-
  99.     Color) bulletin file.  If left blank no file will be written.
  100.  
  101.     COM3 (Base Address and IRQ):  If installed  enter the Base Address
  102.     in Hex (e.g. 03E8) and IRQ of COM3.
  103.  
  104.     COM4 (Base Address and IRQ):  If installed  enter the Base Address
  105.     in Hex (e.g. 02E8) and IRQ of COM4.
  106.  
  107.     After entering all of the information, press 'ESC'.  ST!SETUP will
  108.     ask if you want  to save the configuration  file.   If this is the
  109.     first  time  ST!SETUP  has been  run  or  you  have previously run
  110.     ST!SETUP  but  changed some of the information, press  'Y'.   This
  111.     will  create or update the configuration file  (STACKEM.CFG).   It
  112.     will also create a STACKEM.SCO file if one does not exist. This is
  113.     the score file and is needed for the program to run.
  114.  
  115.     ST!SETUP will then ask if you want to create the registration file
  116.     (STACKEM.REG).   The  registration  file will be needed  when  the
  117.     program is registered, so you will need to answer 'Y' at least one
  118.     time for this file to be created.  Please be sure all  information 
  119.     is correct as your 'Key Number' will be based on this information.
  120.  
  121.     Consult your BBS manual regarding the creation of DOOR batch files
  122.     for your BBS.  STACKEM.EXE  must be started from  the directory it
  123.     resides in for the game to function.  The command line for calling 
  124.     Stack'Em! is as follows:
  125.  
  126.     STACKEM STACKEM.CFG 'Full path and name of BBS information file'
  127.  
  128.     'Full path and name of BBS information file'
  129.  
  130.     This  will be the full path and filename of your  BBS  information 
  131.     file.   For  example:  C:\PCB\PCBOARD.SYS.   Stack'Em!  uses  this
  132.     filename  to  determine the BBS software which is  being  used  as 
  133.     follows:
  134.  
  135.     CALLINFO.BBS (Wildcat 2.xx)
  136.     PCBOARD.SYS  (PCBoard)
  137.     DOOR.SYS     (GAP, Wildcat! 3.0 and other systems using DOOR.SYS)
  138.     SFDOORS.DAT  (SPITFIRE)
  139.     DORINFOx.DEF (RA/QBBS)
  140.  
  141.     Please  note that the DORINFOx.DEF file that RA/QBBS uses  is  not 
  142.     compatible with RBBS.
  143.  
  144.     An example of a batch file for PCBoard:
  145.  
  146.     CD\STACK
  147.     STACKEM STACKEM.CFG C:\PCB\PCBOARD.SYS
  148.     CD\PCB
  149.     BOARD.BAT
  150.  
  151.  
  152.     UPGRADING
  153.     ---------
  154.  
  155.     To upgrade from versions  1.5+,  replace the old  STACKEM.EXE  and
  156.     ST!SETUP.EXE  files  with  the  new  version  1.9  STACKEM.EXE and
  157.     ST!SETUP.EXE files and run ST!SETUP.
  158.  
  159.     To upgrade from earlier versions follow these steps:
  160.  
  161.     1 - Replace the existing STACKEM.EXE with the new STACKEM.EXE.
  162.     2 - Delete your existing STACKEM.CFG.
  163.     3 - Delete your existing STACKEM.SCO.
  164.     4 - Run ST!SETUP to create the new STACKEM.CFG.
  165.     5 - Modify your batch file(s) for the new command line syntax.
  166.  
  167.     Multiple  configuration files are no longer necessary  if  running 
  168.     multi-node.
  169.  
  170.  
  171.     ERRORS
  172.     ------
  173.  
  174.     Any  errors  which may occur  will be written to  the  STACKEM.ERR
  175.     file.  When possible, a descriptive error message will be  written 
  176.     to  STACKEM.ERR  with the exact cause of the error.  If the  error
  177.     cannot  be resolved,  call the  support BBS  (Gulf Coast BBS ) and
  178.     upload a  copy of your  STACKEM.CFG,  STACKEM.SCO and  STACKEM.ERR
  179.     files.  This will allow us to more quickly  determine the cause of
  180.     the error.  All support is handled through the Gulf Coast BBS.
  181.  
  182.  
  183.     MULTI-NODES, NETWORKS, MULTI-TASKERS
  184.     ------------------------------------
  185.  
  186.     Stack'Em!  has  been developed  in  a networked  environment.  All
  187.     multi-node features have been thoroughly tested on multi-node sys-
  188.     tems using DESQview and Peer-To-Peer Local Area Networks. DOS 3.1+
  189.     full record and file locking is supported.  Multiple configuration
  190.     files are NOT necessary when running on multi-node systems.
  191.         
  192.     Stack'Em! is DESQview aware.  It is automatically detected, screen
  193.     and  keyboard I/O are  "well behaved",  and  time slices are given
  194.     back to other applications  where appropriate.  Stack'Em! has been
  195.     tested  with 3 nodes  running simultaneously  under  DESQview (all
  196.     ports locked at 38400) with no noticeable effect on other nodes.
  197.  
  198.  
  199.     MISCELLANEOUS
  200.     -------------
  201.  
  202.     At the  beginning of  each week the score  file will automatically
  203.     be cleared and last week's high scorer will be determined.
  204.  
  205.     If you are using a high speed modem and have your com port LOCKED, 
  206.     the  program will not respond to keyboard input while  your  modem 
  207.     buffer is full.  This is normal.
  208.  
  209.     Stack'Em! may be played from the DOS prompt by typing:
  210.  
  211.     STACKEM STACKEM.CFG LOCAL
  212.  
  213.     Note the user name is hard coded as 'SysOp' and the bulletins  and
  214.     score file will not be updated. Also, play will not be limited  to
  215.     the allowable plays per day set in ST!SETUP. This mode is only for
  216.     testing.
  217.  
  218.     To turn on screen writing, if it is off, press any key.
  219.  
  220.  
  221.     REGISTRATION
  222.     ------------
  223.  
  224.     Registration is required if you choose to continue using this DOOR 
  225.     program.   After 60 days of running the program unregistered,  the 
  226.     score  file  will  cease to be updated.  However,  the  game  will 
  227.     continue  to allow players to play. This should be long enough  to 
  228.     determine if the program meets your needs and is popular with your 
  229.     users.
  230.  
  231.     When  registered, the '[UNREGISTERED COPY]' line will be  replaced 
  232.     with a 'Registered To:' message.  This will show the Name and  BBS 
  233.     Name from the STACKEM.CFG file.
  234.  
  235.     There are two ways to register.
  236.  
  237.                         * Mail order Registration *
  238.  
  239.     If the STACKEM.REG form was not  previously  created, run ST!SETUP
  240.     and have  it  create STACKEM.REG.  Check this  file to  insure the
  241.     information is correct. If it is not, re-run  ST!SETUP and correct
  242.     any errors.   Your Key Number is based on the information in  this
  243.     file  and must be correct for your Key Number to work.  When done,
  244.     print the form  to your printer.  Send the  completed  STACKEM.REG
  245.     form  along  with your  check,  money order,  VISA,  MasterCard or
  246.     Discover credit card information for $15.00 (US) to:
  247.  
  248.                               J & W Software
  249.                           9426 N. China Pink Way
  250.                       Crystal River, FL  34428-9500
  251.  
  252.     Your personalized Key Number will be sent to you promptly. When it
  253.     is received,  run ST!SETUP  and enter  your Key number.  Stack'Em!
  254.     will then be registered.  No other action is necessary.
  255.  
  256.  
  257.                      * Instant On-Line Registration *
  258.  
  259.     You may register  Stack'Em! with  VISA, MasterCard or Discover and
  260.     receive your personalized Key Number instantly by calling the Gulf
  261.     Coast BBS, (904) 563-2547,  and entering REGISTER at the main menu
  262.     prompt.  You  will need the  Name  and  BBS Name  exactly as it is
  263.     entered on  lines 1 & 2  of  ST!SETUP as well as  your credit card
  264.     information to  register.  You  might  want  to make  note of this
  265.     information to speed  your call.  You will receive your Key Number
  266.     on that call.
  267.  
  268.  
  269.     WARRANTY & DISCLAIMER
  270.     ---------------------
  271.  
  272.     There  are  no warranties, express or  implied,  for  unregistered 
  273.     copies of Stack'Em!.  The author will  NOT  be held liable for any
  274.     direct,  indirect, incidental, or consequential  damage  resulting 
  275.     from  the  use  of  this  program.   Your  use  of  this   program 
  276.     constitutes your AGREEMENT to this disclaimer and your release  of 
  277.     the author from any form of liability.
  278.  
  279.     Registered  copies  of  Stack'Em!  are  warranted  to  perform  as
  280.     described  in this  documentation.  In the  event  Stack'Em!  does
  281.     not  perform as described, the author will elect to either rectify
  282.     the  problem or refund  the amount  paid, provided notification is
  283.     received within 30 days of registration.
  284.  
  285.  
  286.                                  - END -
  287.